xgrab is a front for the xgrabsc program. Read the man page for xgrabsc for a description of the options presented by xgrab.
After selecting options from the various categories presented, press the OK button to have xgrab run xgrabsc to let you grab an image from the screen. After you press OK, xgrab's window will disappear and xgrabsc will gain control until the grabbing process is finished. Afterwards, the xgrab window will reappear.
You can also override the default xgrab settings in your .Xdefaults. See the examples section below for instructions.
You can also get fancy and pipe the output through more than one command, such as tee screen.dmp | xwud, to store the grabbed image and get a preview window.
Default settings for xgrab can be made in your .Xdefaults file. For the Athena toolkit version of xgrab, Toggle buttons can be set/unset through their .state attribute, and text field strings can be set through their *string attribute. For the Motif toolkit version (which has diamond-shaped buttons for radio buttons), toggle buttons can be set/unset through their .set attribute and text field strings can be set through their *value attribute.
For example, to set the default paper size for postscript output, put these lines in your .Xdefaults (and use xrdb to load them into the server!):
XGrab*.pageWidthText*string: 8.5
XGrab*.pageHeightText*string: 11.0
or
XGrab*.pageWidthText*value: 8.5
XGrab*.pageHeightText*value: 10.0
To set the default output type to XWD, put these lines in your .Xdefaults:
XGrab*.ps.state: 0
XGrab*.xwd.state: 1
Bruce Schuchardt
Servio Corporation
bruce@slc.com
See the xgrabsc man page, and the Acks file in the xgrabsc distribution for a list of acknowledgements.
Xgrab is copywritten material with a very loose copyright allowing unlimited modification and distribution if the copyright notices are left intact. Various portions are copywritten by various people, but all use a modification of the MIT copyright notice. Please check the source for complete copyright information. The intent is to keep the source free, not to stifle its distribution, so please write to me if you have any questions.
THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.